Cumplir con lo que especifican estas normas es OBLIGATORIO. Por favor revisen todos los puntos aquí discutidos antes de entregar sus proyectos. Las entregas que incumplan cualquiera de las normas aquí descritas obtendrán una nota de cero puntos.

Estructura de Directorios

Las pruebas sobre la compilación y ejecución de los programas serán llevadas a cabo en forma automatizada usando un guión (script), por lo que los proyectos que no cumplan con la estructura de directorios REPROBARAN LA EVALUACION SOBRE LA EJECUCION.

Cada entrega deberá contener la siguiente información. La estructura y los nombres de los directorios deben ser respetados al pie de la letra, sin cambiar singulares por plurales, ni minúsculas por mayúsculas:

1. Un directorio llamado src contentivo de los archivos fuentes del programa.
2. Un directorio src/edu/ucab/ti/razor y subdirectorios con los fuentes del programa.
3. Un directorio parser contentivo de los archivos con las gramáticas.
4. Un directorio parser/edu/ucab/ti/razor/parser con el código fuente generado por ANTLR.
5. Un directorio llamado test contentivo del código fuente de las pruebas.
6. Un directorio llamado lib contentivo de las librerías usadas por el programa.
7. Un directorio doc contentivo de cualquier documentación relacionada con la entrega en formato HTML.
8. Un directorip doc/api contentivo de la documentación de los fuentes generada usando el programa javadoc.
9. Un directorio etc contentivo de cualquier otro archivo relacionado con la entrega.
10. Nada más.

En Eclipse, la estructura del proyecto debe verse así:

Puede obtener un archivo comprimido con una maqueta de proyecto con la estructura de directorios requerida aquí: maqueta_proyecto.zip.

Documentación

Todas las entregas deberán estar acompañadas de por lo menos un archivo llamado index.html en el directorio doc que contenga:

1. Membrete identificando la universidad, facultad, escuela, asignatura, y semestre.
2. Fecha.
3. Los nombres y apellidos de los integrantes del equipo.
4. El nombre y propósito del proyecto.
5. Comentarios respecto a las estrategias utilizadas en la ejecución del proyecto.
6. Comentarios respecto a las dificultades encontradas y las limitaciones presentes en la implementación.

Archivos

• Todos los archivos, incluyendo los programas fuente deben estar identificados con:
  • El nombre de la universidad
  • El nombre de la materia
  • El nombre del proyecto
  • Los nombres de los integrantes del equipo.
• Todos los documentos explicativos deben estar en formato HTML. Los que se encuentren en otro formato (Word por ejemplo) no serán leídos ni considerados de manera alguna en la evaluación.

Programas

Antes de entregar, deben confirmar que sus programas compilan y corren. No se evaluará la ejecución de programas que no sean el producto exacto de los fuentes entregados.